1 
CYBER 180 DEVELOPMENT : 

5/19/78 
ERS for PASCAL Extended Formatter REV: B 


EXTERNAL REFERENCE SPECIFICATION 
FOR 


INTERIM PASCAL EXTENDED FORMATTER V0.0 


Submitted: 


Approved: 


P. We Haynes 


A SD ED AD AD EONS ND AE AD END ED EE NEED AE TE ei RE SD HD 


Re Awe Peterson 


DISCLAIMERS 


This document is an internal working 
paper only. Lt is unapproved and 
subject to changes and does not 
necessarily represent any official 
intent on the part of CDC. 


COMPANY PRIVATE 


CYBER 180 DEVELOPMENT 


5/19/78 
B 


REV: 


ERS for PASCAL Extended Formatter 


REVISION DEFINITION SHEET 


DESCRIPTION 


mm 


Original. 


a 
? 


04/07/78 


] 
‘ 


through 


Updated to reflect comments received 
the DCS review. 


en « Pe He RF Te Oe Be Re TH ee owe Oe! we Re ee Oe OT ee Ee ee ee Ee Oe we Pe we OR Be HT CP OF CS He FH HEF we RF BO THT FH HT 


05/19/78 


Pe Oe me OE me Re Re ER Oe em HE Re Re Re me SN Ee oe Oe me Oe OP Oe RE Oe Se oe PR FF pe ow FH ne Hr we PF ee ew ee we 


COMPANY PRIVATE 


4-1 
CYBER 180 DEVELOPMENT 
5/19/78 
ERS for PASCAL Extended Formatter REV: 8 


1.0 PREFACE 


1.0 PREFACE 


The PASCAL—-X source code formatter described in this document 
is based on past experiences developing and using comparable 
formatters for the ISWL and SWL languages. 


1.1 SCOPE_OF DOCUMENT 


This document is intended to contain information necessary to 
use the PASCAL Extended formatter in oan interactive or batch 
job. 


It is assumed that the reader is familiar with the PASCAL-X 


language and concepts of the NOS operating system. 


1.2 APPLICABLE DOCUMENTS 


PASCAL Extended Language Specification {ARH2298) 
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220 INTRODUCTION 


220 INTRODUCTION 


The PASCAL Extended formatter is a utility used to format 
PASCAL=-X source codes It executes as a standalone product. 


2e1 PURPOSE 


The formatter provides a common tool for formatting PASCAL~X 
source code prior to compilations PASCAL=-X programs formatted by 
a common tool will be more consistenty, readable and 
maintainable. . 


202 OVERVIEW 


The formatter is executed as an absolute file. Input and 
output For the formatter are specified with a NOS control cards 
Formatting may be controfted to a limited extent by the use of 
PASCAL~X pragmats. 
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320 CONVENTIONS 


The formatting conventions are mostiy hard coded into the 


formatter with some conventions being alterable by the use of 
pragmats. 


3e1 INPUT _EILE CONVENTIONS 


1) 


2) 


1) 


2) 


3) 


4) 


Source must be normal PASCAL-X input files (currently the NOS 
6/12 character set). 


Source must be tegitimate PASCAL-X sources but is not 
necessarily a compilation unit. Common decks are 
formattable. 

Source file is assumed positioned and local. 

Qnty one record on source file is formatted, 

Source Yine may ba any length as formatter reads to 
end-of-line. 

FORMATTED OUTPUT_EILE_ CONVENTIONS 

Ald lines will be 79 characters or tess untess altered by a 


pragmat. 


The character set output by the formatter will be identical 
to the inout file character set, 


The formatted output file is created as a local file and is 
not rewound before or after. 


The output file will always start with 1 blank line. 
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343 EQORMATTING CONVENTIONS 


1) 


2) 


3) 


4) 


5) 


6) 


7) 


8) 


9) 


10) 


11) 


12) 


All keywords will be converted to upper case unless altered 
by pragmate The predefined data types tike integers» chars» 
cell» booleans strings arrays records and set will always be 
in fower case. 


All programmer created identifiers will be converted to 
lower case uniess altered by pragmat. 


The case of strings and comments will not be altered. 


Comments Starting at the tJeft hand margin will not be 
formatted. 


Lines with the asterisk control character in column one are 
not formatted. These lines are assumed to be maintenance 
package contro! statements which will be satisfied before 
compilation, 


Blank or empty lines are retained. 


Blanks are squeezed to 1 except within strings and 
comments. 


A 3 (semicolon) will cause a new tine to be started, If a 
trailing comment follows on that same lines it will remain 
there, 


A space wiil be added before and/or after certain 
delimiters. Such as { and j on attribute lists» the 
operatorss etc. 


Keywords that start or terminate a structured statement will 
start anew line. 


Keywords that form a structured statement will cause 
Following statements to have a margin of 2 greater than the 
fine that contains the KEYWORD. Keywords that terminate a 
structured statement will decrease this margin by 2. The 
maximum margin will be 40. 


If there is no blank line before a VAR» TYPEs CONSTs or 
PROCEDURE statements or labels one will be put there. A 
blank line will separate a tocal variable dectaration from 
the procedure statement list. 
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13) 


14) 


15) 


16) 


17) 


13) 


19) 


20) 


21) 


22) 


23) 


24) 


25) 


Each parameter declaration will start anew line when they 
appear within a PROCEDURE declaration. The VAR or value 
attribute will have a margin two spaces greater than the 
margin for the PROCEDURE statement. The maximum margin will 
be 490, 


Identifiers defined in TYPE» VAR» and CONST statements will 
each start on a new line. 


Labels are backed up 2 cotumns from current margin and are 
afone on a line. 


If comments need to be separated across tiness they will be 
separated at a blank and subsequent tines will be tinned up 
with the original line. 


If comments starting at the feft hand margin are too tongs 
they are continued at the left hand margin of succeeding 
lines until the comment is completed. : 


The Jeft hand column defauits to 1 untess aitered by a 
pragmat. The starting margin is equal to the teft hand 
column. 


NOTE: The first input tine is given amargin of l. 


Pragmats that are processed by the formatter take effect 
after their appearance in the source. 


The formatter checks column one of the input stream and if 
it is non-numeric or the asterisk control characters the 
information is assumed to be text. 


The formatter stops execution and outputs an appropriate 
message upon detecting the first syntax error. The status 
of the output file is undefined, 


The THEN clause of the IF statement wil! normally be on the 
same line as the IF» space permitting. 


The ELSE and IFEND clauses are aligned with the IF 
statement. 


CASE selection specs will have the same margin as their 
associated CASE statement. 


Statements that exceed the length of a tine wild be 
continued on the following tine with a 2 character 
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26) 


indentation. 


Long strings that do not fit on a single tine will be split 
and the CAT operator generated. 


344 SUGGESTIONS 


the 


The following Jist of formatting features will not be done by 
interim formatters but should be strongty considered for the 


ultimate PASCAL~-X formatter. 


Q 


6] 


Formatting of PLs» 


Filling in the labels on ending detimiters of tabeled 
structured statements» procends and nodends. 


Verifying that if the 4th character of a name is a $ signs 
then the 3rd character must conform to the C€180 System 
Interface Standard. 


Enforcing C180 ceding conventions as they are defined. This 
includes capitalization of keywords and user defined 
identifiers. 


Recognition and justification of comments within a comment 
diock. 


Develop a method of highlighting changes in flow of execution 
caused by the EXIT» CYCLE and RETURN statements. 


Investigate readability of tabbing the ‘!3:! in a types 


variables fieltd or parameter specification to a fixed 
position. 
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4.0 PRAGMATS 


Pragmats appearing in the source are used to control the 
PASCAL-X formatter and will be copied to output to provide a 
graceful means of reformatting, 


4e1l PASCAL=X_ PRAGHATS 


These PASCAL-X pragmats control the PASCAL-X compiler as well 
as the formatter. 


4el.l ??RIGHT %:= N22? 


For the PASCAL-X formatters, this pragmat is used to specify 
maximum output line fength with n >= 72 and <= 110. The default 
value is 79. This pragmat indicates to the PASCAL-X compiler the 
maximum ftength of a source line. 


4ei.2 2??LEFT 2:2 N?? 


Used to make the PASCAL-X compiler and formatter ignore any 
foreign data outside the PASCAL~X syntaxe For the formatter» 
this pragmat indicates left hand output column and starting 
margin. Tne default value is 1. The foreign data which exists 
in the ignored column positions wili be copied to the output 
file. | 


402 FORMATTER_ PRAGMAT 


This pragmat controls only the PASCAL-X formatter and is not 
processed by the PASCAL-X compiler. 
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4e2e1 SYNTAX 


<formatter pragmat statement> ::= 2??<formatter pragmat>?? 
<formatter pragmat> %3:= EMT (<toggle setting list>) 

<toggie setting list> 232 <togglie setting> EFs<toggie setting>] 
<toggie setting> 3:3:= <toggle identifierd t= <condition> 
<toggle identifier> %::= FORMAT i KEYW ? IDENT 


<condition> :#= ON ! GEE $ UPPER ! LOWER 
4e222 TOGGLE IDENTIFIERS 


o FORMAT 


Used to control formatting of all lines. Default is FORMAT <= 
ONe 


FORMAT ?= QN — All source lines are formatted. 


FORMAT := OFF -—- No source lines are formatted. 


o) KEYW 
Used to control! capitalization of keywords. Default KEYW ?= 
UPPER. 
KEYW 3s UPPER - All keywords will be upper case. 
KEYW 3= LOWER - AIS Keywords will be lower case. 
o IDENT 


Used to control capitalization of identifiers. Default IDENT 
3= LOWER. 


IDENT 32 UPPER = All identifiers will be upper case. 


IDENT s= LOWER — Alt identifiers will be tower case, 
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5°90 USE_OE_EQRMATTIER 


The PASCAL~X formatter is executed as an absolute file. 


ATTATHs PASFORM/UN=LP3 
PASFORMCO(<I=filenamedl [<s0=filename>d)] 


Specifies the name of the file to be formatted. If 
I is not specifieds the name of the file is I. 


Specifies the name for the formatted file. If 0 is 
not specified» the name of the file is 0.4 


NOTE: I and 9 may not use the same file name. 
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629 EXAMPLES 


Sel QOURCE PROGRAY 


1) 2?7RIGHT 2= 11072? 
MODULE M1; 
PROCEDURE Al; 

VAR I: INTEGER; 
PROCEND Al3$ 
MODEND M13 


Formatted is: 


P2RIGHT i= 
MODULE M1; 


PROCEDURE Al; 


VAR 
IT? INTEGER; 
PROCEND Al; 
MODEND M13 


2) 22?RIGHT t= 722? 

MODULE M13 

PROCEDURE Al; 

VAR 
It INTEGER; 

CONST J=5;3 

PROCEND Al; 
MODEND M13 


Formatted is: 


P2IRIGHT := 7222 
MODULE M1; 
PROCEDURE Al; 


VAR 
I: INTEGERS 
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CONST 

J353 
PROCEND Al3$ 

MODEND M13 


62 CONTROL _CARDS 


GETsIT=SQURCE,. 
ATTACHs PASFORM/UN=LP3. 
PASFORM. 
REPLACE »sOD=COMPILE. 
The file COMPILE will contain the formatted program found on 
File SOURCE. 
6,3 MESSAGES 


Messages are written to the OUTPUT file and the dayfile,. The 
source line that caused the error message will normaliy be the 
last one on the output file. 

1) ***UNBALANCED 3LOCK STRUCTURE*** 


Begin and end statements for structured statements do not 
match. 


2) *#kIMPROPER PARAMETER LIST#*#* 
Something is wrong with a PROCEDURE definition statement. 
3) ***EXTRANEQUS RIGHT PARENTHESIS *** | 
Right and teft parens do not match. 
4) #***MISSING RIGHT PARENTHESIS*** 
Right and left parens do not match. 
5) **** IMPROPER CASE LABEL ¥** 
Improper case statement. 


6) ***X IMPROPER PRAGMAT*** 
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Something is wrong with a pragmat that the PASCAL-X formatter 
processese 


7) #*** IMPROPER HEX CONSTANT#** 

Something is wrong with a hex constant. 
8) ***IDENTIFIER TOG LONG*** 

Have an identifier greater than 31 characters. 
9) *** IMPROPER STRING CONSTANT ¥¥* 


A quote is missing at EQL causing a syntactic error. 
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